K 線資料

介面描述

取得K 線資料，可查詢指定代幣（僅支援USDT交易對）和指定時間段內不超過1000條的K 線資料。

使用情境：

• 適用於查詢不同時間窗口類型的K 線資料查詢
• 適用於結合價格K 線判斷買賣時機

資料更新頻率：依 bucketType 即時更新

請求 URL

• 方法：POST
• 路徑：/open/v1/trade/kline/getTradeKLineList

點數消耗

• 消耗點數：2

前置條件

取得 vsTokenId

條件	說明	取得方式
已有 vsTokenId	直接使用快取的 vsTokenId，無需重複查詢	上下文自動提取
未有 vsTokenId	呼叫 POST /vs-token/list 介面取得	前置介面呼叫

請求參數

參數透過請求體（Body）以 JSON 格式傳遞。

參數名	類型	必需	描述
vsTokenId	long	是	代幣 ID
bucketType	string	是	K 線時間窗口類型
startTime	long	否	開始時間（毫秒時間戳）
endTime	long	是	結束時間（毫秒時間戳）
size	integer	否	查詢記錄數，預設360條，最大不超過1000條

列舉值說明

bucketType - K 線時間窗口類型

值	含义
5m	5 分鐘
15m	15 分鐘
30m	30 分鐘
1h	1 小時
4h	4 小時
1d	1 天
1w	1 週

回應欄位

僅展示 data 物件內的欄位結構：

欄位	類型	實際回傳類型	描述
vsTokenId	long	string	代幣 ID
symbol	string	string	代幣符號
name	string	string	代幣名稱
klineType	string	string	K 線類型
klineData	array	array	K 線資料
time	long	long	時間（毫秒時間戳）
open	number	string	開盤價
close	number	string	收盤價
high	number	string	最高價
low	number	string	最低價
volume	number	string	成交量
amount	number	string	成交額(USD)

欄位業務含義

欄位	業務含義	使用建議
volume	成交量	反映該時間週期的交易活跃程度
amount	成交額	以USD計價的交易金額，結合volume可計算成交均價

請求範例

{
    "vsTokenId": 1,               // 代币 id
    "bucketType": "5m",            // K线时间窗口类型
    "endTime": 1773478632535,      // 结束时间
    "size": 20                     // 查询记录数，默认360条，最大不超过1000条
}

cURL 範例（Linux/macOS）

curl --location --request POST 'http://${host}/api/open/v1/trade/kline/getTradeKLineList' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: xxxxx' \
--header 'X-TIMESTAMP: xxxxx' \
--header 'X-SIGN: xxxxx' \
--header 'Accept: */*' \
--data-raw '{
    "vsTokenId": 1,
    "bucketType": "5m",
    "endTime": 1773478632535,
    "size": 20
}'

cURL 範例（Windows CMD）

curl --location --request POST "http://${host}/api/open/v1/trade/kline/getTradeKLineList" ^
--header "Content-Type: application/json" ^
--header "X-API-KEY: xxxxx" ^
--header "X-TIMESTAMP: xxxxx" ^
--header "X-SIGN: xxxxx" ^
--header "Accept: */*" ^
--data-raw "{    \"vsTokenId\": 1,    \"bucketType\": \"5m\",    \"endTime\": 1773478632535,    \"size\": 20}"

成功回應範例

{
    "code": 200,
    "message": "success",
    "data": {
        "vsTokenId": "1",                       // 代币 ID
        "symbol": "BTC",                         // 代币符号
        "name": "Bitcoin",                       // 代币名称
        "klineType": "01",                       // K线类型
        "klineData": [
            {
                "time": 1773478200000,            // 时间
                "open": "70544.92",                // 开盘价
                "close": "70594.48",               // 收盘价
                "high": "70594.49",                // 最高价
                "low": "70536.58",                 // 最低价
                "volume": "20.543779999999995",    // 成交量
                "amount": "1449509.9399093997"     // 成交额(USD)
            },
            {
                "time": 1773477900000,
                "open": "70562.01",
                "close": "70544.92",
                "high": "70586.21",
                "low": "70536.72",
                "volume": "57.95012",
                "amount": "4089095.6473876997"
            },
            {
                "time": 1773477600000,
                "open": "70612.38",
                "close": "70562",
                "high": "70613.76",
                "low": "70562",
                "volume": "14.238029999999998",
                "amount": "1004960.1104217"
            }
            // ... 更多数据省略
        ]
    },
    "requestId": "xxx-xxx-xxx"
}